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APPENDIX I - Playback Engine Partial Exemplary Code 



Although aspects of the invention have been described in considerable detail, Appendix I 
provides a sample of exemplary code so that some additional insight may be gained as to its 
5 structure and operation. 

r 

These are example functions from a Story playback engine which illustrate one possible software 
implementation of a remarkably lightweight Story operating environment. 

10 

These functions illustrate most all the functionality needed for the story multi-threading, media 
synchronization and runtime model for Story playback. 

The first two functions perform the functions of implementing a round-robin, multi-threaded operating 
15 system. 

The second two functions illustrate functions that implement actual Story op-code execution. 
□ *' 

J— StoryPlaybackCycle should be called continually in a loop on a single host operating system thread. 
This functions executes all the threads once in order, until each thread gives up control, then returns. 

is 

4= Possible return code #deflnes can be found in pStory.h and end with the suffix, "_RETURN_CODE" 

j.£ When the return value is negative, then execution of the calling loop should end. 

U V 

36 S32 FUNC_PREFIX StoryPlaybackCycle(void) 

! < 

jlk SU32 u32_NumberOfActiveThreads=0; 

SU32 u32_NumberOfThreadsLefr=p.c.u32_NumberOflnitiali2edThreads; r 
35 number of initialized threads */ 

p.c.u32_StoryPlaybackCycleNumber++; 
p.c.u32_StoryThread!ndex=0; 
while (u32_NumberOfThreadsLeft) 
{ 

40 p.c.context=p.c.contexts[p.c.u32_StoryThreadlndex++]; 

if (p.c.context.u32_State!=RUNNING_CONTEXT_STATE) 
{ 

45 u32_NumberOfThreadsLeft-=(p.c.context.u32_State!=UNlNITIALIZED_CONTEXT_STATE 

); 

continue; r this thread is not running so do next thread */ 

} 

u32_NumberOfActiveThreads++; 

50 

if (InputAvailableO) 
{ 

do 
{ 

55 Process! nstructionO; 

} while 
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(p.c.s32_ProcesslnstructionReturnCode==SUCCESS_RETURN_CODE); 
if (p.c.s32_ProcesslnstructionReturnCode<0) 
{ 

break; 

5 } 
} 

p.c.co ntexts[p.c.u32_StoryTh read lndex-1]= p. c. context; 
u32_NumberOfThreadsLeft-; 

10 } 

if (u32_NumberOfActiveThreads===0) 

^ p.c.s32_Process!nstructionReturnCode=NO_ACTIVE_THREADS_RETURN_CODE; 
} 

1 5 return(p.c.s32_ProcesslnstructionReturnCode); 
} 

r 

This function fetches an opcode from the input buffer and calls the function that implements the 
20 opcode. It also handles instruction retry by: 

ls ;f Setting the default status returned from the opcode function to 

^ SUCCESS_RETURN_CODE 

2 Storing the pointer to the opcode 

r 25 Calling the function for the opcode 

*iM Inspecting the return code when the opcode function returns 

!:n If the return code is RETRY_INSTRUCTION_RETURN_CODE then the instruction pointer is reset to 

lip point back to the opcode by restoring the saved value. 

30 */ 

i \ void FUNC_PREFIX Processlnstruction(void) 

PSU32 pu32_SavedNextlnput; 
^ pu32_SavedNextlnput=p.c.context.inputBufferlnfo.pu32_Nextlnput; 

35 p.c.u32_CurrentOpcode=GetSU32_FromlnputO; 

U p.c.s32_ProcesslnstructionReturnCode=SUCCESS_RETURN_CODE; 

Cl (controlFunctionAddressArray[p.c.u32_CurrentOpcode])0; 

if (p.c.s32_ProcesslnstructionReturnCode==RETRYJNSTRUCTION_RETURN_CODE) 

{ 

40 //Instruction could not proceed, so try again next time 

p.c.context.inputBufferlnfo.pu32_Nextlnput=pu32_SavedNextlnput; 

} 

return; 

} 

45 

r 

Stop execution of this thread until all the other threads have had a chance to run. The return code, 
YIELD_TO_NEXT_THREAD_RETURN_CODE, has a different value than a 
50 SUCCESS_RETURN_CODE. 

This will cause the main cycle function to move on to executing the next thread. 
When the cycle function gets back to executing this thread, execution will proceed starting with the 
instruction following the YIELD_OP instruction. 
55 V 

void FUNC_PREFIX YieldOp(void) 

{ 

p.c.s32_ProcesslnstructionReturnCode=YIELD_TO_NEXT_THREAD_RETURN_CODE; 
return; 

60 } 
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r 

End ops are used to end subroutines and disable threads. 

Note that after the last running thread ends, then the story playback will automatically end. 
*/ 

void FUNC_PREFIX EndOp(void) 

^ RETURN_ADDRESS_STACK_ELEMENT_TYPE rase; 
SU32 u32_i; 

if (p.c. context. u32_SubroutineNesting Level) 
{ 

p.c.context.u32_SubroutineNestingLevel— ; 

Pop((PSU8)&rase, sizeof(rase)); 

px.context.inputBufferlnfo=rasejnputBufferlnfo; 

p.c.context.pu32_Parameters=rase.pu32_Parameters; 

p.c.context.pFilelnfo=rase.plnputFilelnfo; 

for 

(u32_i=0;u32_i<rase.u32_NumberOfElementsOnStackToPopUponReturn;u32_i++) 
{ 

Pop(NULL.O); 

} 

} 

else 

{ I* Thread Ended its own Execution */ 

p.c.context.u32_State=SUSPENDED_CONTEXT_STATE; 

p.c.s32_ProcesslnstructionReturnCode=YIELD_TO_NEXT_THREAD_RETURN_CODE; 
} 

return; 

} 



END OF APPENDIX I 



